home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Aminet 7
/
Aminet 7 - August 1995.iso
/
Aminet
/
comm
/
mebbs
/
fst231.lha
/
fustick 2.31
/
fustick.doc
< prev
next >
Wrap
Text File
|
1994-09-05
|
19KB
|
606 lines
****************************************************************************
* *
* FUSTick 2.8 by Robert Wahlström 94-Mar-13 *
* *
* Copyright © by Robert Wahlström All rights reserved. *
* *
* Process and hatch .ticfiles *
* *
* Written in SAS C 6.51 with CygnusED Pro & Chelp on Amiga 4000/040. *
* *
* Robert Wahlström *
* Enehagsg 197 *
* S-441 57 ALINGSÅS SWEDEN *
* *
* Usenet: d0robert@dtek.chalmers.se *
* Fidonet: 2:203/316.0 *
* Amiganet: 39:160/303.0 *
* *
* *
* Support BBS: UTILITYBASE +46-322-17877 16.8kHST+V32" 2:203/316.0 *
* *
****************************************************************************
$VER: FusTick 2.8 (94-Mar-13) © by Robert Wahlström 1994
1. INTRODUCTION
===============
WHAT IS FusTick?
FusTick is a utility that handles file echo .tic files.
At the moment FusTick works with MEBBSNet and as a stand alone program.
2. LICENSE
==========
This material is © Copyright 1994 by Robert Wahlström -- All rights reserved.
It may be distributed freely as long as the following restrictions are met:
The distributor may charge a fee to recover distribution costs. The fee for
diskette distribution should not be more than the cost to obtain the same
diskette from Fred Fish.
The distributor agrees to cease distributing the programs and data involved
if requested to do so by the authors.
You may copy and distribute verbatim copies of the program's executable code
and documentation as you receive it, in any medium, provided that you
conspicuously and appropriately publish only the original, unmodified program,
with all copyright notices and disclaimers of warranty intact and including
all the accompanying documentation, example files and anything else that came
with the original.
The author will not be liable for any damage arising from the failure of this
program to perform as described, or any destruction of other programs or data
residing on a system attempting to run the program. While I know of no
damaging errors, the user of this program uses it at his or her own risk.
3 REQUIREMENTS
==============
AmigaDos 2.0 or higher.
Mebbsnet 0.158
4 INSTALLATION
==============
Put FusTick anywhere. (Ex in directory MebbsNet:c)
FUSTick NEEDS a configutation file called TICK.CFG this file can
be placed in the directory from where FUSTick is started.
If an Env variable is set FUSTick gets the configuration file name from
the ENV variable.
EX: setenv FusTick MebbsNet:ConfigFiles/tick.cfg
Fustick gets Tick.cfg from MebbsNet:ConfigFiles/tick.cfg
If FusTick is started with the argument CONFIGFILE=<configfil>
The argument filename will be used INSTEAD of the ENV variable namne.
Fustick also handles a datafile to be used from other FUS utilities like the
TickStat (Fileecho statistics utility)
Example configuration file:
5 CONFIGFILE
============
HERE <Address>
[AKA <Address> [Address] ... ]
PASSWORD <Address> <Password>
[EMAILAREA] <areanumber>
[CHECK_CRC]
[IN <Inbound Path>]
[OUT <Outbound Path>]
[BAD <Bad Files Path>]
[COPYTIC <copy tic path>]
[LOGFILE <Path/Name for log>]
[LOGLEVEL <level>]
[LIST <TagPattern> <ListName> [<OutputFormat>]]
[HOLD <node>]
[MEBBS] - Signals FUSTICK that you are using MEBBS and without this line
FUSTICK can't add files to the MebbsNet file areas.
[UTC <offset i min>]
[DEFAULTAREA <name>]
; FileEcho block. ONE block for each file echo AREA
FILEECHO <AreaTag> <Directory>
[FILEAREA <AreaName>]
[MAKEFREE]
[NOHATCH]
TO [<address> <address> <address>... ]
Items in square brackets "[]" are optional, depending upon the
environment. See breakdown below. Items in "greater than" and
"less than" symbols "<>" are not literal, but should be replaced by
appropriate data. Lines are >NOT< case sensitive, and may be
preceded or followed by whitespace. Blank lines and sections of
lines following a semicolon ";" will be treated as comments and
ignored.
HERE <Z:Net/Node.[point]>
-------------------------
The "HERE" parameter tells FusTick what your system's FidoNet
address is. This must be your 3 or 4 dimensional address.
ex: HERE 2:203/316
HERE 2:203/316.5
[AKA <Address> [Address] ... ]
-------------------------------
If your system is using AKA addresses enter them here like:
ex: AKA 39:160/105
PASSWORD <Z:Net/Node[.point]> <Password>
----------------------------------------
All system that you send/recive files from MUST be listed in the
password list.If FUSTICK fails to find a node or correct password.
The file and the tic file will go to a BAD directory.
ex:
PASSWORD 2:203/316 UtilityBase
PASSWORD 2:203/129
PASSWORD 2:203/316.5 dfhg
EMAILAREA <Area number>
-----------------------
The number of your email area.
Default 1
CHECK_CRC
---------
Having this line in your Tic.cfg file is a good ide since it
checks if the file is corrupt in some way and no one likes to
get bad files via a file echo.
IN <Inbound Path>
-----------------
Your inbound directory. The default is "MebbsNet:in/".
ex:
IN MAIL:inbound/
OUT <Outbound Path>
-------------------
Your outbound directory. The default is "Mebbsnet:out/".
ex:
OUT MAIL:outbound/
BAD <Bad Files Path>
--------------------
The directory where all bad files (unknown area, failed CRC check,
from unknown system, Tick files without the appropriate file) are
moved to. The default is "MebbsNet:bad/".
ex:
BAD MAIL:BAD/
COPYTIC <copy tic path>
-----------------------
Backup directory for all incoming ticfiles.
Default: No backup
ex:
COPYTIC back:tic/
LOGFILE <logfil>
----------------
Name and path to logfile.
Recommended: Assign a directory to hold the LOGfiles.
like:
Assign LOG: Mail:log (wish this could be a standard log dir) :-)
(We DONT want them in MebbsNet: its full of stuff anyway)
ex:
LOG:FUSTick.log
LOGLEVEL <level>
----------------
Loglevel value 1-9. Higher value - more logging
level 3 is default
ex LOGLEVEL 5
HOLD <Z:Net/Node[.point]>
-------------------------
This indicates that the .flo files should be HELD until the
reciving node calls you. (The .FLO is changed to .HLO file.)
Note that this option ONLY works with 4 dimentional addresses
(read Trapdoor or other external mailer)
ex: HOLD 2:203/129.0
HOLD 2:203/316.5
LIST <TagPattern> <ListPath/Name> <OutputFormat>
------------------------------------------------
This line is used to generate a listing of the files processed
by FusTick. There may be any number of these lines, limited by
memory of course, and they may each act upon any number of
echos. Below is an explanation of each field:
<TagPattern>
This is a simple pattern match, which indicates which echos
are to be considered for listing in this listfile. It accepts
the MS-DOS type "?" and "*" , and Amiga-DOS wildcard characters.
<ListPath/Name>
This is the path and name of the file FusTick should make the
file list in.
<OutputFormat>
This is the format FusTick should use when adding to the list
file. It is a very powerful way to specify the look of the
list. Those who know C will recognize the syntax of the format
specifier, those who don't may have a little trouble
understanding it. All text is copied exact except for
sequences starting with a percent "%" symbol. They work as
follows:
%[-][<w>]<t>
Where:
%
is the escape to a sequence - must prefix all of
them.
[-]
is an optional dash meaning "Left justify this field"
[<w>]
is the optional (fixed) width of the field. Replace
this with the appropriate number if you wish to make
your listing in columns, otherwise the field will be
of variable length. If field is numeric (i.e. CRC,
length) a leading 0 may be specified to pad the
leading end of the number with 0's.
<t> is the type of field. There are 7 types supported:
a areaname
c crc Form: Hex digits
d description
l length Form: Decimal digits (in bytes)
n filename
o origin address Form: (Z:Net/Node)
Examples:
LIST SKY* ADSFILES.LST Area: %a\nName: %n\nLength: %l\nDesc:
%d\nOrigin: %o\nCRC: %c\n
LIST NODE* FIDOFILE.LST %-12a | %-14n - %d\n
The first would result possibly in this listing being generated:
Area: SKYUTILS
Name: CH136_E.LHA
Length: 44060
Desc: Chelp 1.36 [eval] - Search in autodocs & includes
Origin: 1:150/111
CRC: 6623414
While the second would result in something like this:
NODEDIFF | NODEDIFF.A45 - FidoNet NodeDiff for day 145
NODEDIFF | NODEDIFF.A59 - FidoNet NodeDiff for day 159
'\n' is replaced by a newline character when printed.
A '\n' must be placed at the end of the line.
It is fine to have multiple LIST lines pointing to the same file,
as long as the tag patterns are mutually exclusive (or duplicate
listing will occur).
If no output format is specified, the following is default:
%-16a | %-13n | %7l | %d\n
MEBBS
-------
Notifies that MebbsNet is the BBS program you are using
Without this comand FUSTICK cant send files to the MEBBSNET file areas.
UTC [offset]
------------
The offset value specifies the time in minutes to calculate the
UTC from your local time. This value is added to your local time
before FusTick inserts any date-/time-strings into the path-lines
of a .tic file.
Sweden -60 (summertime(GMT)) -60 (wintertime(CET))
UK 0
ex: UTC -60
DEFAULTAREA [namn]
------------------
Tells FUSTICK what default area to use when hatching files.
ex: DAEFAULTAREA SKYPROG
FileEchoblock
=============
FILEECHO <AreaTag> <Path>
-------------------------
Indicates the start of an 'Area Block' all lines below this line
has to do with ONE fileecho area.
All paths MUST end with an / or :
ex:
FILEECHO ADSMEBBS DIV:files/mebbs/
<Path> MUST be present if you dont want to add the incomming files
wiht its descriptions to the MEBBSnet Fileareas.This might be convienient
if you want to add the file to another directory.
If the FILEAREA command is present with the area actuall Areaname
the file will be added to MEBBSnet fileare listings and the physical file
will be copied to the appropriate directory.
FILEAREA <Area name>
--------------------
The actual name in your BBS for the file area where you want your
incomming files.
ex:
FILEECHO ADSMEBBS
FILEAREA Mebbs Utilities
TO 2:203/424.0
TO 2:203/319.0
MAKEFREE
--------
Enter this if you want the areas incomming files to be Free download.
NOHATCH
-------
If you don't want to hatch files in this area.
ex:
FILEECHO NODEDIFF mail:nodelist/
NOHATCH ; Don't hatch in nodediff
TO 2:203/316.5
TO <Z:Net/Node.[point]> <Z:Net/Node.[point]> <Z:Net/Node.[point]>...
--------------------------------------------------------------------
ex:
TO 2:204/641.0 2:204/455.0
Tells Fus tick who to send recived files to
Note that if your BBS is the last in the chain and you are NOT
sending it to anyone else just enter a blank TO statement in those areas.
ex:
FILEECHO NODEDIFF mail:nodelist/
TO
FILEECHO NEWSTARTICK work:lc/prg/snet/newstartic/fil/
FILEAREA Utilities
TO 2:203/300
FILEECHO SKYUTILS work:bbs/fl/utils/
MAKEFREE
FILEAREA Graphics
TO 2:203/129
TO 2:203/600 2:203/235.5
6 Running FusTick
=================
FUSTick arguments:
FUSTick [HATCH] [CONFIGFILE=<configfile>] [PUBSCREEN=<pubscreenname>]
[LIST] [QUERY=<nodenuber>]
CONFIGFILE - Tells FUSTICK to use another configuration file the the
default one (Tick.cfg) OR the file specifyed with the ENV
command.
ex:
FusTick CONFIGFILE=work:special_tick.cfg
HATCH - Puts FUSTICK into HATCH mode and open hatchwindow.
PUBSCREEN - Open Hatchwindow on a publicscreen
ex:
FusTick HATCH PUBSCREEN=DOPUS.1
QUERY - List all active areas for node [nodenumber]
ex:
FusTick QUERY=2:203/316
LIST - List all availible areas
ex:
FusTick LIST
7 The HATCHING of FILES
=========================
FusTick HATCH
Opens a window that is used to hatch files in to an file echo.
The "square" at the right are used to select the filearea to hatch
the file in.
FILE Field:
Are used to select the file to hatch.
You could also use a regular file requester to select file to hatch
with the TINY gadget at the window.
enter something like: Work:prog/FUSTick_101.lha
AS field:
Tells Fustick under what name the file should be sent.
ex: FST101.lha
DESC field:
Where to enter the file description.
ex: FusTick 2.7 Nice tick utility for MEBBS.
TO FILAREA gadget:
Used if you want the file sent to your own BBS fileareas.
CYCLE gadget:
Selects type of outgoing file HOLD, NORMAL or CRASH
HATCH:
When everything is set this one is selected to actual HATCH the file
8 TickStat
==========
Tickstat is a small utility that monitors the amount of incomming fileecho
files.
TickStat [-f<statdatafil>]
Tickstat Tries to get the information from tick.log.dat
Tickstat -f<datafil> Uses the dat file from the one entered.
ex:
TickStat -flog:Tick.log.dat
ex of running tickstat:
TickStat 0.04 © 1992 Robert Wahlstrom
Area Today Week Month Year Total
==========================================================
ADSFIDO 7 7 7 7 7
SKYTEXT 3 3 3 3 3
SKYCOMMS 0 50 50 50 50
NODEDIFF 0 59 59 59 59
SKYPROGS 0 104 104 104 104
SKYUTILS 145 393 393 393 393
FUS_FILES 0 171 171 171 171
ADSWORK2 0 78 78 78 78
Total: 156 868 868 868 868
9. ADDRESSES AND PHONENUMBERS
=============================
If You have any questions, suggestions or bug-reports, please contact us.
NetMail, snailmail, voice or logging on to our support bbs's.
Here are addresses and phonenumbers:
Robert Wahlstrom
Enehagsg 197
S-441 57 ALINGSÅS
SWEDEN
phone: +46 (0)322-183 31
Support BBS:
UtilityBase +46 (0)322-178 77 v32" + 16.8k HST
Fido: 2:203/316.0 Amiganet: 39:160/303.0
Usenet: d0robert@dtek.chalmers.se
MEBBSnet Service Center (SWEDEN):
Yggdrazil bbs +46 (0)11-164276 Line 1
+46 (0)11-107033 Line 2
+46 (0)11-107037 Line 3
+46 (0)11-107069 Line 4
Fido: 2:204/455.0
10. CREDITS
===========
Thanks to the following for hints, suggestions and debugging:
Kejll Harnesk - alfatesting, many ideas.
Kjell Cederfeldt - alfatesting, many ideas.
Mikael Johansson - alfatesting
Stefan von Straten - MEBBS support Sweden, Documentation.
William Bowling - MEBBS
11 Other programs by Robert Wahlström
=====================================
FusEdit - Fullscreeneditor for MEBBS
FusAC - Areafix for MEBBS
FusList - Very configurable filearea list creator
Chelp - A help program for programmers - Lookup functions in autodocs
and strcuts/defines in includefiles
Ast - Astronomyprogram (beta only)